ICONEDIT 3A V1.1c Copyright 1994 Stephen Robertson 106 All Saints Road, Northfleet, Kent, DA11 8RN DISTRIBUTION You may freely distribute ICONEDIT 3A providing that all copies are identical and all copies contain the above copyright notice. ICONEDIT 3A MAY NOT BE SOLD OR DISTRIBUTED COMMERCIALLY IN ANY WAY WITHOUT THE AUTHOR'S WRITTEN PERMISSION. Though this version of ICONEDIT 3A (v1.1c) is SHAREWARE, I (the author) require no payment for this version, but I reserve the right to charge for future updated versions, or to sell them commercially. COMMENTS I've tested ICONEDIT 3A thoroughly, but it's quite likely that one or two bugs have slipped past me. If you find any then please let me know. Also, If you have any other comments regarding ICONEDIT 3A, such as ideas for new features, or improvments or even just to say that you like ICONEDIT 3A and use it a lot, then please contact me. The more positive feedback I get, the more likely it is that I'll update ICONEDIT 3A, and include new features. Contact me at the above address, or via PEPSIMAX @ CIX. I don't have a CIX account, but PEPSIMAX has kindly uploaded this for me. WHAT IS ICONEDIT 3A? It's a utility written in OPL especially for the Psion Series 3a that allows you to create icons and other bitmaps for your own programs or for other utilities. It has taken me three months to write, comprises approx. 35k of source code and was coded in its entireity on an unexpanded 512k Psion Series 3a. HOW DO I INSTALL IT? * Copy the ICONED3A.OPA to the APP directory on any Psion drive. * Make a directory in the same APP dir, called ICONED3A. * Copy the two cursor bitmap files CURSOR-A.CRS and CURSOR-B.CRS into the ICONED3A directory you just created. * If you haven't got a PIC directory, then create one in the root directory of each of the drives you wish to save icons to. * Finally, select INSTALL from the FILE menu and select ICONED3A.OPA The ICONEDIT 3A icon should then appear, with a file list below it if you already have a PIC directory and .PIC files. HOW MUCH MEMORY DOES IT NEED? The actual ICONEDIT 3A OPA takes up about 15k of space. When running ICONEDIT 3A uses about 40k of memory. WHAT TYPE OF FILES DOES IT USE? It loads and saves 48x48 bitmaps with both a black an grey plane. The file extension it uses is .PIC, and these files are saved in a PIC directory in the root directory of A, B or the internal disk. HOW DO I RUN ICONEDIT 3A? ICONEDIT 3A runs, and uses files in exactly the same way as the other standard psion applications. To run it select ICONEDIT 3A on the system screen, and press return. If there are no .PIC files then ICONEDIT 3A will create one called ICONED3A.PIC when it is run. If there are .PIC files then ICONEDIT 3A will display a list of them below its icon, and you may select one of these and press return to run the program and load the file. If you wish to create a new PIC file, you may do so using the FILE menu on the system screen. SCREEN LAYOUT The large window with a grid on the left of the screen is the EDIT window. This is a magnified version of the DRAW window which is displayed next to it. Most drawing actions take place in the EDIT window, and are also displayed in the draw window simultaneously. The UNDO window shows what picture would replace the one in the DRAW window, if the UNDO function were used. The ICON status window which is on the right of the DRAW window shows the current cursor coordinates plus the current drawing shade and the drawing mode. On the extreme right hand side of the screen is the application status window, as used by most Psion Series 3a applications. The diamond list has three items, BLACK, GREY and ERASE. The item with the diamond character next to it is the shade that ICONEDIT 3A is currently drawing in. HOW DO I USE ICONEDIT 3A? To move the drawing cursor around the screen press the cursor keys. If you press SHIFT+cursor the cursor will skip to the next grid space (4 pixels). If you press PSION+cursor, then the cursor will jump to the edge of the icon, in the direction indicated by the cursor. If you move the cursor off the edge of the EDIT window it will appear on the opposite side. To draw you have two methods: For continous drawing, hold down CONTROL and press the cursor keys. Wherever you move the cursor, pixels will be drawn. For fine work, use the TAB key, this draws singe pixels, and performs a toggle action - press once to set a pixel and again to clear it. MENUS If you press the MENU button a menu will be displayed. FILE MENU NEW FILE - PSION+N Creates a new icon. The program will prompt you to confirm the new file if there are unsaved changes. OPEN ICON - PSION+O Loads in a new icon. The program will prompt you to confirm the open if there are unsaved changes. When the icon is loaded, the EDIT window is redrawn. With a complicated icon using black and grey shades this may take a few seconds. SAVE - PSION+S Saves the current icon to the same file name. SAVE AS - PSION+A Saves the current icon to a new file. MODE MENU ICONEDIT 3A works in MODES. It starts off in DRAW MODE, where pixels may be drawn, but other drawing modes are selectable. DRAW MODE - d or PSION+D In DRAW MODE you can draw single pixels in BLACK, GREY or WHITE (erase) using CONTROL+CURSOR for continuous drawing, or TAB for togglng single pixels. The shade used is shown in the status windows. Draw mode is the default mode, and ICONEDIT 3A defaults to this after completing/aborting an action in any other mode. LINE MODE - l or PSION+L This mode allows you to draw straight lines between any two points in any shade. If you select this mode, then when you next move the cursor a "rubber band" line will be drawn between the start point and the cursor in the EDIT window. If you change your mind and wish to stop DRAW mode, then pressing ESC will place you back in DRAW mode. Pressing RETURN will cause a line to be plotted between the start position and cursor position on both the EDIT and DRAW windows. BOX MODE - b or PSION+B This mode draws hollow boxes in any shade between two corner positions. Selecting this mode then moving the cursor causes a rubber band" box to be drawn between the original position and the cursor. Pressing RETURN causes the box to be drawn in both the EDIT and DRAW windows. As in LINE mode, pressing ESC aborts the mode. SOLID BOX MODE - B or SHIFT+PSION+B Exactly the same as BOX mode, except the boxes are filled with the current shade. BORDER MODE - O or SHIFT+PSION+O This allows you to draw Series 3/3a style 3d borders, and works the same way as BOX mode, except that when RETURN is pressed a dialog will appear. The dialog allows you to change the type of border drawn. Pressing RETURN will cause the border to be drawn in the DRAW WINDOW. The EDIT window will be refreshed to show the new border. SPECIAL MENU GRID ON/OFF - g or PSION+G Toggles the visible grid on/off. Turning the grid off causes a partial re-draw, and so may take a couple of seconds. ERASE ICON - PSION+E Clears the EDIT and DRAW windows, thus erasing the current image. If there are unsaved changes you will be prompted to confirm it. STORE TO UNDO Copies the DRAW window to the UNDO window, so that you have a backup that you can restore using UNDO. This is done automatically for you every time you draw a line, box, solid box or border, and when you erase the icon. It's a good idea to do a STORE TO UNDO before doing any drawing in DRAW mode, as drawing pixels in this mode doesn't trigger a STORE TO UNDO. UNDO - u or PSION+U Copies the undo window to the draw window and redraws the EDIT window, thus undoing any changes since the last "STORE TO UNDO" EXIT, LOSE CHANGES - SHIFT+PSION+X Quits ICONEDIT3A without saving the icon. If there are any unsaved changes you will be asked to confirm this. EXIT - PSION+X Quits ICONEDIT 3A, saving any changes. DIAMOND MENU DRAW BLACK - + Set current shade to black for draw, line, box and solid BOX modes This may be done in any mode, even while a "rubber band" box or line is shown. DRAW GREY - - As above, but sets shade to grey. ERASE - / As above, but sets shade to white (erase). ICONEDIT 3A KEY REFERENCE Where more than one key is available for a particular function the alternatives are separated by commas; e.g. PSION+G, g MENU - Display menu HELP - Display Help menu DIAMOND - Change shade forwards SHIFT+DIAMOND - Change shade backwards CURSOR KEYS - Move cursor CURSOR+SHIFT - Move cursor 1 grid (4 pixels) CURSOR+PSION - Move cursor to edge of EDIT window CURSOR+CONTROL - Draw pixels in current shade while moving cursor TAB - Toggle single pixel in current shade PSION++, + - Select Black PSION+-, - - Select Grey PSION+/, / - Select Erase PSION+N - New Icon PSION+O - Open Icon PSION+S - Save Icon PSION+A - Save Icon as new filename PSION+D, d - Start Draw Mode PSION+L, l - Start Line Mode PSION+B, b - Start Box Mode SHIFT+PSION+B, B - Start Solid Box Mode SHIFT+PSION+O, O - Start Border Mode RETURN - Activate mode operation (e.g. draw line, box) ESC - Abort mode operation (e.g. quit line mode) PSION+G, g - Toggle visible grid on/off PSION+E - Erase current icon SHIFT+PSION+S - Store icon to UNDO window SHIFT+PSION+X - Exit ICONEDIT 3A, without saving changes PSION+X - Exit ICONEDIT 3A, saving changes